home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / mengen.zip / MENGEN.DOC < prev    next >
Text File  |  1992-04-10  |  16KB  |  423 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         ╒═════════════════════════════════════════════════════════╕
  8.         │                                                         │
  9.         │      ██   ██                   ████                     │
  10.         │      ███ ███                  ██  ██                    │
  11.         │      ███████  ████   █████   ██       ████   █████      │
  12.         │      ███████ ██  ██  ██  ██  ██      ██  ██  ██  ██     │
  13.         │      ██ █ ██ ██████  ██  ██  ██  ███ ██████  ██  ██     │
  14.         │      ██   ██ ██      ██  ██   ██  ██ ██      ██  ██     │
  15.         │      ██   ██  ████   ██  ██    █████  ████   ██  ██     │
  16.         │                                                         │
  17.         │                 ╒═════════════════════╕                 │
  18.         ╘═════════════════╡     Version 1.0     ╞═════════════════╛
  19.                           ╘═════════════════════╛
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.    ╒════════════════════════════════════════════════════════════════════════╕
  29.    │                         Disclaimer Of Waranty                          │
  30.    │                                                                        │
  31.    │    Mengen               is provided as is and carries no warranty      │
  32.    │    whatsoever.  ZhofWare disclaims and excludes any and all implied    │
  33.    │    warranties of merchantability, title and fitness for a particular   │
  34.    │    purpose.  ZhofWare does not warrant that the software will satisfy  │
  35.    │    your requirements or that the software is without defect or error   │
  36.    │    or that operation of the software will be uninterrupted.  You are   │
  37.    │    using the software at your risk.                                    │
  38.    │                                                                        │
  39.    ╘════════════════════════════════════════════════════════════════════════╛
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.    ┌───────────────────────────────────────┐
  47.    │ MENGEN Fixes                          │
  48.    └───────────────────────────────────────┘
  49.  
  50.    If you currently have Mengen installed, please read the following
  51.    section.
  52.  
  53.    Rev B.
  54.    ════════
  55.  
  56.    Due to an error on our part, the first upload of Mengen, did not support
  57.    the single user feature as we had advertised. This release 'B' does
  58.    correct that problem.
  59.  
  60.    To install the new release, simply replace the MENGEN.EXE and MENLIB.EXE
  61.    that are currently installed on your server, with the ones included in
  62.    this zip. Also, re-compile your menu script file using MENLIB.
  63.  
  64.    This should fix any problems encountered where personal options were not
  65.    included on the menu.
  66.  
  67.  
  68.  
  69.    ┌───────────────────────────────────────┐
  70.    │ MENGEN v1.0 - Evaluation Copy         │
  71.    │ (c) 1991 ZhofWare All Rights Reserved │
  72.    └───────────────────────────────────────┘
  73.  
  74.     Mengen is a Novell Menu System compilation utility which takes full
  75.     advantage of the Bindery features on Novell operating systems 2.x
  76.     and 3.x
  77.  
  78.     Mengen will free system administrators from ever creating another
  79.     Novell menu file again, it will also ease the burden of updating possibly
  80.     thousands of menu files when only one simple change needs to be made.
  81.  
  82.     This is done by creating one master menu library file that is maintained
  83.     by any text editor. Once this master library file has been created, Mengen
  84.     goes to work. The following is a step by step analysis of how mengen
  85.     operates :
  86.  
  87.                A) Mengen Determines if a menu file already exists
  88.                   for the current user. If so, it determines if the menu
  89.                   file is up to date, by comparing the library file
  90.                   date and time to the menu file data and time.
  91.  
  92.                B) If no menu file is found for the current user, or
  93.                   it is not up to date ,  Mengen will then compile a
  94.                   list of all the groups that the current user is a
  95.                   member of.
  96.  
  97.                C) Mengen then checks the library to see if any personal
  98.                   options exist for this user, if so it adds them to the
  99.                   menu file.
  100.  
  101.                D) Next Mengen compares the list of groups to the Library
  102.                   file and begins to generate a menu for the current
  103.                   user according to the group information.
  104.  
  105.                D) Mengen terminates after menu file is generated.
  106.  
  107.  
  108.       As you can see this utility has a variety of advantages, some of them
  109.       are listed below.
  110.  
  111.                1) No need to throw away or trade in your Novell Menu
  112.                   system for those higher priced slower systems.
  113.  
  114.                2) System wide menu updates upon change of menu library.
  115.  
  116.                3) Un-necessary menu selections no longer appear on
  117.                   users menus.
  118.  
  119.                4) Tightens security holes.
  120.  
  121.       The version of Mengen provided in this evaluation copy is fully
  122.       functional for 30 days. Upon the thirty day expiration, it will
  123.       terminate and no longer generate menu files.
  124.  
  125.       Please Feel Free to share and distribute this product, with your
  126.       friends and associates.
  127.  
  128.       Support and general information on the Mengen evaluation system
  129.       should be directed to :
  130.  
  131.                         ZhofWare
  132.                         P.O. Box 37
  133.                         East Bernard, Tx 77435
  134.                         (409) 335-6262
  135.  
  136.       Registered users will receive a printed manual and free technical
  137.       support.
  138.  
  139.  
  140.  
  141.    ╒════════════════════════════════════════════════════════════════════════╕
  142.    │                              Files Included                            │
  143.    │                                                                        │
  144.    │    MENGEN.EXE    - The Menu Generator                                  │
  145.    │    MENLIB.EXE    - The Menu Library Compiler                           │
  146.    │    MENGEN.DOC    - Documentation File                                  │
  147.    │    MENBLD.DAT    - Example Menu Script File                            │
  148.    │                                                                        │
  149.    ╘════════════════════════════════════════════════════════════════════════╛
  150.  
  151.  
  152.    ┌───────────────────────────────┐
  153.    │ Building the Menu Script File │
  154.    └───────────────────────────────┘
  155.  
  156.  
  157.    The menu script file is created much the same as a Novell .MNU file,
  158.    except it has a few more identifiers. Actually, you can take an
  159.    existing .MNU file and just wrap the Mengen identifiers around it,
  160.    and your through.
  161.  
  162.    The following is a sample script file for Menlib to generate the
  163.    menu library file.
  164.  
  165.    Study the example carefully.
  166.  
  167. ; ************************************************************************
  168. ; Sample menu file, to generate Novell Menu using MenGen.
  169. ; Remarks may be added by using the ";" character
  170. ; use this as a guide for building your own scripts.
  171. ; (c) Copyright 1991 ZhofWare , All rights reserved.
  172. ; ************************************************************************
  173.  
  174. ^%Mengen v1.0 Sample Menu Script File^ ;^ denotes the main menu header,
  175.                                        ;  which must come before any other
  176.                                        ;  options in script file.
  177.  
  178. /&PROGRAMMERS&/                  ; & denotes the beginning of a group.
  179. A. Programming Tools             ;   the group name must match exactly what
  180.    %Available Tools              ;   is defined in the File Server's bindery.
  181.  
  182. /#PROGRAMMERS#/             ; # denotes the beginning of a sub-menu for
  183.                             ;   this group. The text between the #
  184. %Available Tools,5,20,0     ;   signs must match the group name exactly.
  185. Turbo Pascal
  186.    TURB
  187. Turbo C
  188.    TC
  189. Turbo Debugger
  190.    td
  191. Microsoft Windows 3.0
  192.    win
  193. /#PROGRAMMERS-SUB-END#/     ;  Here we designate the end of the sub-menu
  194. /*PROGRAMMERS-END*/         ;  by adding -SUB-END to the group name.
  195.                             ;  and finaly end the group definition by
  196. /&DBASE&/                   ;  using /*GROUP_NAME-END*/
  197. B. DBASE
  198.    F:
  199.    DBASE
  200. /*DBASE-END*/
  201.  
  202. /&LOTUS_COLOR&/
  203. C. LOTUS
  204.    K:
  205.    LOTUS
  206. /*LOTUS_COLOR-END*/
  207.  
  208. /&WORD_PERFECT&/
  209. D. WORD PERFECT NETWORK
  210.    WPNET
  211. /*WORD_PERFECT-END*/
  212.  
  213. /&CCMAIL&/
  214. E. ELECTRONIC MAIL
  215.    MAIL
  216. /*CCMAIL-END*/
  217.  
  218. /_WILSON_/                           ;  Mengen not only handles group
  219. Wilson's Personal Area               ;  menu items, but also user
  220.  %personal                           ;  custom options.
  221. Wilson's Utility Area                ;
  222.  %util                               ;  If you have a user, that just
  223.                                      ;  has to have thier very own personal
  224. /_#WILSON#_/                         ;  options, just insert them here.
  225. %personal                            ;
  226. Personal Filer                       ;  Notice to designate individual
  227.    PF                                ;  users we use the "_" char.
  228. Personal Editor                      ;
  229.    PE                                ;  If the user wants sub-menus for
  230. %Util                                ;  personal selections, No problem.
  231. System Configuration                 ;  just use the "_#" char's to
  232.   syscon                             ;  indicate the sub menu for them.
  233. File Server Console
  234.   fconsole
  235. /_#WILSON-SUB-END#_/
  236. /_WILSON-END_/              ;  Here we designate the end of the user's
  237.                             ;  personal options, by adding _#USER-SUB-END#_
  238.                             ;  and finaly end the user definition by
  239.                             ;  adding /*USER_NAME-END*/
  240.  
  241.  
  242.  
  243.  
  244.    ┌───────────────────────────────┐
  245.    │ Building the Menu Script File │
  246.    └───────────────────────────────┘
  247.  
  248.    The following is a list of the available mengen identifiers :
  249.  
  250.         ;   - Denotes a comment in the script file
  251.                 Example :
  252.                            ; This is a comment
  253.  
  254.         ^   - Denotes the Header for the Main menu portal
  255.                 Example : ^Network Main Menu^
  256.  
  257.         /&  - Denotes the beginning of a group definition
  258.                 Example : /&APPLICATIONS&/
  259.                            menu code
  260.                            "
  261.                            "
  262.                           /*APPLICATIONS-END*/
  263.  
  264.         /#  - Denotes the beginning of a sub-menu for a group definition
  265.                 Example : /&APPLICATIONS&/
  266.                            menu code
  267.                            "
  268.                            "
  269.                           /#APPLICATIONS#/
  270.                            sub-menu code
  271.                            "
  272.                            "
  273.                           /#APPLICATIONS-SUB-END#/
  274.                           /*APPLICATIONS-END*/
  275.  
  276.         /_  - Denotes the beginning of a user's personal definition
  277.                 Example : /_USERNAME_/
  278.                           menu code
  279.                           "
  280.                           "
  281.                           /_USERNAME-END_/
  282.  
  283.         /_# - Denotes the beginning of a user's personale sub menu
  284.               definition.
  285.                 Example : /_USERNAME_/
  286.                           menu code
  287.                           "
  288.                           "
  289.                           /_#USERNAME#_/
  290.                           sub=menu code
  291.                           "
  292.                           "
  293.                           /_#USERNAME-SUB-END#_/
  294.                           /_USERNAME-END_/
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.    ┌────────────────────────────────┐
  302.    │ Compiling the Menu Script File │
  303.    └────────────────────────────────┘
  304.  
  305.     Once you have created the Mengen script file, you are ready to
  306.     compile it using the MENLIB program.
  307.  
  308.     To run MENLIB, type the following :
  309.  
  310.         MENLIB [ Script filename ]
  311.  
  312.     Menlib will then open the script file and begin processing it.
  313.     Once menlib has completed, there will be two new files in the
  314.     current directory. These are :
  315.  
  316.                 MENGEN.LIB - The actual library file
  317.                 MENGEN.$DX - The library index file
  318.  
  319.     Copy these two file to the SYS:PUBLIC directory on the file server
  320.     and flag them Shareable Read Only.
  321.  
  322.     That's all there is to compiling a MENGEN script file.
  323.  
  324.  
  325.    ┌────────────────────────────────────┐
  326.    │ Running Mengen - Generating Menus  │
  327.    └────────────────────────────────────┘
  328.  
  329.    Mengen, the menu generator, will create a menu file named USERNAME.MNU
  330.    in the current working directory. If needed, a filename can be passed
  331.    on the command line to designate the name of the .MNU file.
  332.  
  333.    User's who execute Mengen must have Read Write Create And Delete rights
  334.    to the current working directory in which Mengen is to build the menu file.
  335.    It is suggested, that Mengen either execute in the user's home directory or
  336.    in a designated menu file directory that users have these trustee privledges.
  337.  
  338.    The following is an example of how to implement Mengen .
  339.  
  340.         **** example login script ****
  341.  
  342.         MAP DISPLAY OFF
  343.         MAP S16:=FILESERVER/SYS:PUBLIC
  344.         MAP S16:=FILESERVER/SYS1:USER\%LOGIN_NAME
  345.         MAP *1:=FILESERVER/SYS1:USER\%LOGIN_NAME
  346.  
  347.         rem  Login name may be replaced with any other
  348.              identifier.
  349.  
  350.         EXIT "MEN %LOGIN_NAME"
  351.  
  352.         **** end of example login script ****
  353.  
  354.         **** example batch file ****
  355.  
  356.         rem *** MEN.BAT
  357.         rem *** execute Mengen menu generator and then the novell menu
  358.         rem *** system.
  359.         Echo off
  360.         mengen %1
  361.         menu %1
  362.  
  363.         **** end of example batch file ****
  364.  
  365.         Notice above exiting from the login script and calling MEN.bat
  366.         with the %LOGIN_NAME as the first parameter. This will execute
  367.         Mengen, which will create a .MNU file in the current directory
  368.         with the name of %LOGIN_NAME.MNU and execute the novell Menu
  369.         system with the same .MNU file.
  370.  
  371.  
  372.  
  373.  
  374.    ┌────────────────────────────────────┐
  375.    │ Ordering Information               │
  376.    └────────────────────────────────────┘
  377.  
  378.    Mengen v1.0 is available for only $49.00 per file server.
  379.  
  380.    You may order a fully functional version of Mengen by sending this
  381.    completed form to :
  382.  
  383.  
  384.                         ZhofWare
  385.                         P.O. Box 37
  386.                         East Bernard, Tx 77435
  387.                         (409) 335-6262
  388.  
  389.                             Order Information
  390.    (*-----------------------------------------------------------------*)
  391.  
  392.    Company Name : ________________________________________
  393.  
  394.    Contact      : ________________________________________
  395.  
  396.    Street       : ________________________________________
  397.  
  398.    State        : __            Zip ________
  399.  
  400.    Phone        : ___ - ___ - ____
  401.  
  402.  
  403.                             Order   Information
  404.    (*-----------------------------------------------------------------*)
  405.                     Circle
  406.     Product         Media                       Qty     Unit     Total
  407.     ------------------------------------------------------------------
  408.      Mengen v1.0    5 1/4                       ___     49.00    _____
  409.                     3 1/2
  410.     __________________________________________________________________
  411.  
  412.                                 Texas Residents
  413.                                 add 8% sales tax        Tax      _____
  414.                                                         Total   ______
  415.  
  416.    (*-----------------------------------------------------------------*)
  417.  
  418.    Please remit by Cash, check or Money order. Orders will be processed
  419.    within 48 hours of receipt. Checks and Money orders must be US funds
  420.    only.
  421.  
  422.  
  423.